home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1991 …esperately Seeking Seven / Desperately Seeking Seven.2mg / Dev.CD.8 / Essentials / Tools / File.Type.Notes / FTN.CA.XXXX < prev    next >
Encoding:
Text File  |  1989-07-23  |  5.5 KB  |  104 lines  |  [04] ASCII Text (0x0000)
  1. Apple II
  2. File Type Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6.  
  7. File Type:         $CA (202)
  8. Auxiliary Type:    Reserved
  9.  
  10. Full Name:     Finder Icons File
  11. Short Name:    Icons
  12.  
  13. Written by:    Matt Deatherage                                      July 1989
  14.  
  15. Files of this type and auxiliary type contain icons.
  16. _____________________________________________________________________________
  17.  
  18. The Apple IIGS Finder keeps the icons it uses in files of type $CA.  The 
  19. Finder searches for these files in a directory named Icons on each volume 
  20. mounted.  Each icon contains information not only describing the icon and its 
  21. mask (both regular and "small icon" sizes), but also information to match the 
  22. icon to files from their file type, auxiliary type, and filename.
  23.  
  24. The Finder first attempts to load the file Finder.Icons from the Icons 
  25. directory on the boot disk, stopping with a fatal error if it is not present 
  26. (this file contains icons for devices as well as the icon to match files with 
  27. no other icon).  It then loads other icon files from that directory, and then 
  28. from other disks.
  29.  
  30. The format of icon files is as follows:
  31.  
  32. +000    iBlkNext   Long     When loaded by the Finder, this is the 
  33.                             handle to the next icon file (a linked 
  34.                             list terminated by zero).  On disk, this 
  35.                             field should be zero.
  36. +004    iBlkID     Word     ID number of this type of icon file.  This 
  37.                             field must be $0001 for the Finder to 
  38.                             recognize the icon file.
  39. +006    iBlkPath   Long     When loaded by the Finder, this is the 
  40.                             handle to the pathname of this icon file.  
  41.                             On disk, this field should be zero.
  42. +010    iBlkName   16 Bytes A 16-byte String of the name of the icon 
  43.                             file.
  44. +026    iBlkIcons  IconData A list of Icon Data records.
  45.  
  46. The format of Icon Data records is as follows:
  47.  
  48. +000    iDataLen    Word    The length of this Icon Data record.  A 
  49.                             value of zero in this field terminates the 
  50.                             list of Icon Data records.
  51. +002    iDataBoss   64 Bytes  The pathname of the 
  52.                             application that owns this icon.  If this 
  53.                             String has non-zero length, and the file 
  54.                             this icon is associated with is a document 
  55.                             (not an application, folder, device, or 
  56.                             trash can), the Finder attempts to launch 
  57.                             a file with this pathname when this icon 
  58.                             is opened or printed.  This string should 
  59.                             be empty for non-documents.  This is a 
  60.                             full pathname, and most developers 
  61.                             creating icons will wish to set this to 
  62.                             the full pathname of the application on 
  63.                             the shipping disk.
  64. +066    iDataName   16 Bytes  A 16-byte String containing a 
  65.                             file name.  Files on disk must match the 
  66.                             specification of this string or this icon 
  67.                             will not be displayed for the files.  The 
  68.                             asterisk (*) serves as a wildcard 
  69.                             character.  For example, the string *.ASM 
  70.                             matches all filenames ending with the 
  71.                             characters .ASM.
  72. +082    iDatatype    Word   File type associated with this icon.  
  73.                             Files on disk must have this file type for 
  74.                             this icon to be displayed.  A file type of 
  75.                             $0000 in this field matches any file type 
  76.                             on disk.  As an example, an application 
  77.                             icon would want to have the filename of 
  78.                             the application in the iDataName field and 
  79.                             the file type $00B3 (GS/OS Application) in 
  80.                             this field.  Without the file type 
  81.                             specification, the icon would show up for 
  82.                             any file with the application's file name, 
  83.                             including a folder on a hard disk in which 
  84.                             the user has placed the application.
  85. +084    iDataAux     Word   Auxiliary type associated with this icon.  
  86.                             Similar to the file type field, a value of 
  87.                             $0000 here matches any auxiliary type on 
  88.                             disk.
  89. +086    iDataBig     Icon   The normal size icon image data.
  90.         iDataSmall   Icon   The small size icon image data.
  91.  
  92. The format of Icon records is the same as that listed in the QuickDraw II 
  93. Auxiliary chapter of the Apple IIGS Toolbox Reference Manual.  Previous icon 
  94. structure documentation stated the iconType field of the Icon record (also 
  95. known as the imType field) had to be zero.  This is no longer true; the Finder 
  96. respects color icons (bit 15 of iconType set) by not coloring the icon in 
  97. funny ways, even if the user asks for it.  The Finder still does this if bit 
  98. 15 of iconType says the icon is a black-and-white icon.
  99.  
  100.  
  101. Further Reference
  102. _____________________________________________________________________________
  103.     o    Apple IIGS Toolbox Reference, Volume 2
  104.     o    Apple IIGS Icon Editor